home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #265 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #265 (1993)(Rhein-Sieg-Soft).adf / ak_gen0-lib_V38.1.LHA / ak_gen0-Library / AK_GEN0-Lib_ENG.doc < prev    next >
Text File  |  1993-07-30  |  7KB  |  267 lines
  1.  
  2.               ak_gen0.library V38.1
  3.  
  4.                - FREEWARE -
  5.  
  6.          (c) 1989-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           This program was written under OS V3.00 and is therefore
  9.           fully compatible. It needs OS >= V1.2.
  10.  
  11.           Next generation of the "ak.library".
  12.  
  13.           Release Date : 30.07.1993
  14.  
  15.  
  16.     Copyright :
  17.     ===========
  18.  
  19.     The program ak_gen0.library V38.1 and its documentation files are
  20.     (C)opyright 1989-93 by Andreas R. Kleinert. All rights reserved.
  21.  
  22.     The "ak_gen0.library" may be used for own program projects, if those
  23.     are PUBLIC DOMAIN or FREEWARE.
  24.  
  25.     Programmers of SHAREWARE, which charge a share-fee higher than 20,-DM
  26.     (or $15), or programmers of commercial programs have to get the explicite
  27.     permission of the author (me) to use the library. Contact me to get
  28.     informed about my conditions.
  29.  
  30.  
  31.     Disclaimer :
  32.     ============
  33.  
  34.     The author takes no responsibility for any results of the use of this
  35.     program.
  36.     This software is provided "AS IS" and there is no warranty of any kind,
  37.     so that you use this software at your own risk.
  38.  
  39.  
  40.     Distribution :
  41.     ==============
  42.  
  43.     The program ak_gen0.library V38.1 is freely distributable (FREEWARE).
  44.     You may copy it, if the copyright notice is left intact and
  45.     all of its parts are included in the distribution.
  46.     This program must not be included in commercial packages or commercial
  47.     program collections without my written permission.
  48.     This program must not be sold in any way, but it is allowed to take
  49.     a nominal fee including the costs for copying.
  50.  
  51.     This program may be put on public domain disks or included in public
  52.     domain disk libraries.
  53.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  54.     the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
  55.  
  56.     This program may also be distributed via electronic mail and may be
  57.     put into mailboxes as long as the redistribution conditions are
  58.     respected in all points.
  59.  
  60.     By using or distributing this program you automatically agree to
  61.     all of the above conditions and terms.
  62.  
  63.  
  64.     Functions :
  65.     ===========
  66.  
  67.     The "ak_gen0.library" is used in many of my programs and it consists of
  68.     many functions, which make programming much easier (e.g. the programming
  69.     of "Intuition").
  70.  
  71.  
  72.     Installation :
  73.     ==============
  74.  
  75.     Just copy the "ak_gen0.library" into your "LIBS:"-directory.
  76.  
  77.  
  78.     Usage :
  79.     =======
  80.  
  81.     The "ak_gen0.library" consists of ...
  82.  
  83.      - Functions for comfortable opening of Windows and Screens
  84.      - Functions for simple creation of Gadgets, Menus, Submenus, etc.
  85.      - Functions for simple print-out of Texts
  86.      - an easy to handle FileRequester, which is completely managed by the
  87.        Library
  88.        (under OS V2.04+ the FileRequester of the "asl.library" is called
  89.        instead)
  90.      - an easy to handle ScreenMode-Requester, which is completely managed
  91.        by the Library
  92.      - a random-number generator
  93.      - Functions to wait for special events as "Left Mousebutton pressed"
  94.        or "Key ??? pressed"
  95.      - etc.
  96.  
  97.     Read the file "AK_GEN0-Lib_Reference.doc", to get a full description of
  98.     its functions.
  99.  
  100.     Note : "ak_gen0.library" makes use of some of Exec's "Lists&Nodes"-
  101.        functions. If your OS-Version is "buggy" inside these, try
  102.        to use "SetPatch Vx.xx".
  103.  
  104.  
  105.     Correspondence :
  106.     ================
  107.  
  108.     If you like, you may send me some money. Perhaps this will motivate me
  109.     to continue programming such programs or just making updates of
  110.     this one. Send bug-reports, money or whatever to :
  111.  
  112.        Andreas R. Kleinert,
  113.        Grube Hohe Grethe 23,
  114.        D-57074 Siegen,
  115.        Germany.
  116.  
  117.  
  118.     History :
  119.     =========
  120.  
  121.      V38.1 :
  122.      -------
  123.  
  124.       - "code-splitting"
  125.       - "new look" for Prop-Gadgets under Intuition V37+
  126.       - fixed Mode-Names under OS 1.3 :
  127.  
  128.     Lores [Interlace] -> LowRes [Interlace]
  129.     Hires [Interlace] -> HighRes [Interlace]
  130.  
  131.       - ModeRequester now also recognizes PAL and NTSC under
  132.     OS 1.3
  133.       - new Default-Flag (AKBase) for the ModeRequester :
  134.     Use of the "real" MaxOverScan-Values (-1*MinX + MaxX, ...)
  135.     as Maximum Values for Width and Height.
  136.     Example :
  137.           HighRes 724x283 instead
  138.                of 652x268
  139.  
  140.     IN THIS VERSION STILL "PRIVATE" (upto V38).
  141.  
  142.       - the Function "AK_ReadDir()" (OBSOLETE) now internally uses
  143.     also "AK_GetDirList()" / "AK_FreeDirList()", while
  144.     value -1 is returned if an error occurs.
  145.     This should be compatible, because anyway there's only the
  146.     following possible way to read the data
  147.  
  148.      for(i=0; i<=count; i++) printf("%s (%ld)", direntry[i], dirtype[i]);
  149.  
  150.     from the structures.
  151.  
  152.      - four new functions for memory management :
  153.  
  154.        - AK_GetMemList
  155.  
  156.      allocates list for memeory management
  157.  
  158.        - AK_FreeMemList
  159.  
  160.      allocates list for memeory management and memory entries
  161.  
  162.        - AK_AddMemEntry
  163.  
  164.      adds an entry to the list
  165.      (if not possible, memory will be delocated)
  166.  
  167.        - AK_AllocMemEntry
  168.  
  169.      allocates memory and adds an entry to the list
  170.  
  171.  
  172.      V37.95 :
  173.      --------
  174.  
  175.       - Requester now also can be controlled via keyboard :
  176.  
  177.     - internal FileRequester (only for OS V1.3, not with ASL) :
  178.  
  179.        ESC      : Cancel
  180.        P      : Parent
  181.        A      : Assigns
  182.        1..8   : Select Entry
  183.        Return : Confirm
  184.  
  185.     - ModeRequester :
  186.  
  187.        ESC      : Cancel
  188.        1..8   : Select Entry
  189.        Return : Confirm
  190.  
  191.  
  192.      V37.89 :
  193.      --------
  194.  
  195.       - Requester-Type was not set, so memory was not delocated
  196.       - completely new memory management for the Requesters
  197.     (new, yet internal Routines)
  198.       - optimizations inside the Requesters
  199.       - Propgadget-Structures now 100% local
  200.       - bug in ModeRequester (undefined entries) fixed
  201.  
  202.  
  203.      V37.87 - V37.88 :
  204.      -----------------
  205.  
  206.       - AK_AutoRequester() modificated
  207.       - Propgadget-Structures now local/static
  208.  
  209.  
  210.      V37.85 - V37.86 :
  211.      -----------------
  212.  
  213.      - little bug-fixes
  214.      - smaller Code-Size
  215.      - corrected Documentation
  216.  
  217.  
  218.      V37.83 :
  219.      --------
  220.  
  221.      - major update
  222.      - five new functions :
  223.  
  224.        - AK_GetDirList
  225.  
  226.      allocates list for Directory-Content and fills it
  227.  
  228.        - AK_FreeDirList
  229.  
  230.      delocates List with Directory-Content
  231.  
  232.        - AK_GetModeList
  233.  
  234.      allocates list for Screen-Modes and fills it
  235.  
  236.        - AK_FreeModeList
  237.  
  238.      delocates List with Screen-Modes
  239.  
  240.        - AK_ModeRequest
  241.  
  242.      NEW : SCREEN-MODE-REQUESTER !!!
  243.  
  244.      - Use of SAS/C V6.00 :
  245.     - better Code (less bytes)
  246.     - Include-Files now with "tagcall" Pragmas
  247.       (Note : Use Pragmas when possible !
  248.           If ANY Pragmas are used, but
  249.           the "ak_gen0.library" is used with the Stubs,
  250.           you may (will) get Gurus/Alerts !!! )
  251.      - new Include-File "ak_gen0_obsolete.h" with old definitions, etc.
  252.      - bug-fixes (not many, but nevertheless !)
  253.      - and more
  254.  
  255.  
  256.     [ Version-History of versions before V37 is no longer
  257.       included. ]
  258.  
  259.  
  260.     Copyrights :
  261.     ============
  262.  
  263.     Some of the mentioned names or products above may be copyrighted by
  264.     companies or trademarks of companies.
  265.  
  266.  
  267.